Структура и подключение JavaScript-кода

ОБЯЗАТЕЛЬНОДЛЯ НОВИЧКОВ

Разработчику Архитектору

Подключение и структура кода

Способы подключения скриптов

JavaScript можно добавить на страницу трёмя способами:

• как значение атрибута в теге (inline);
• как отдельный тег <script>;
• как отдельный файл в формате .js.

---

Встроенный скрипт (inline)

Встроенный скрипт (Inline Script) — это фрагмент кода, который выполняется непосредственно внутри документа или файла, в котором он находится, без необходимости выносить его в отдельный внешний файл и подключать через тег ссылки (например, <script src="...">).

Код находится внутри того же источника данных, где он используется. Скрипт загружается и интерпретируется/компилируется вместе с основным файлом. Браузер или интерпретатор встречает этот блок и выполняет его сразу при чтении потока данных.

Встроенный скрипт (inline) – прямо внутри HTML, путём указания функции сразу после события в теге (однако это загромождает HTML):

<button onclick="alert('Привет!')">Нажми меня</button>

Встроенный скрипт работает благодаря интеграции всех возможностей в современных браузерах, позволяя не добавлять обширный скрипт для простых активностей. К примеру, если страница простая и не несёт в себе глубокой логики, работы с данными и задача лишь добавить немного «специй» к элементу – выполняется просто добавление выполнения функции в соответствующий тег.

Таким образом, мы получаем JavaScript возможность внутри HTML-тега.

Но использовать этот метод не рекомендуется, если задач много – допустим, если будет несколько десятков кнопок на странице, и у каждой будет расписан скрипт внутри атрибутов тегов кнопок – будет страшный и плохо читаемый код.

Вариант 1. Обработчик события как атрибут тега

<тег событие="выражение_или_вызов_функции">

Примеры:

• <button onclick="alert('Привет!')">Нажми</button>
• <input oninput="validate(this.value)">
• <div onmouseover="highlight()" onmouseout="unhighlight()">

Этот шаблон описывает прямое связывание пользовательского действия (события) с выполнением JavaScript-выражения прямо в разметке.

Вариант 2. Вызов функции из глобальной области видимости

<тег событие="имяФункции(аргументы)">

Пример:

• <button onclick="submitForm()">Отправить</button>

Подразумевается, что имяФункции объявлена в глобальной области видимости — либо в теге <script>, либо во внешнем файле, подключённом до этого элемента.

Вариант 3. Использование стрелочной функции в inline-обработчике

<button onclick="(() => { alert('Сработало!'); })()">Жми</button>

Редкий, но возможный шаблон, позволяющий использовать современный синтаксис даже в inline-контексте. Не рекомендуется из-за снижения читаемости.

Вариант 4. Передача контекста элемента в обработчик

<button onclick="handleClick(this)">Кнопка</td>

<script>
  function handleClick(element) {
    element.style.backgroundColor = "yellow";
  }
</script>

Шаблон позволяет передавать сам HTML-элемент в функцию, что удобно для динамического изменения его свойств.

---

Код внутри тега script

Тег <script> — это элемент HTML, предназначенный для встраивания или подключения исполняемого кода (скриптов) в документ. Служит мостом для загрузки внешнего ресурса, содержащего логику, по URL.

Тег является контейнером. Между открывающим <script> и закрывающим </script> помещается код, либо указывается ссылка на внешний файл через атрибут src.

Внутри <script> в HTML – код пишется в качестве содержимого тега:

<script>
  console.log("Этот код выполнится сразу!");
</script>

Этот подход отличается от предыдущего тем, что скрипт – это содержимое тега <script> - все необходимые функции вписываются между открывающим и закрывающим тегом. Он подойдёт для случаев, когда на странице немного логики, и её можно упаковать в одном месте.

Тегов <script> на странице может быть много, но, если они разбросаны по всему коду страницы, расположены в разных местах – читать будет очень сложно. Если понадобится поменять что-то, что используется везде – можно упустить фрагмент, или где-то поломать логику.

Если строк кода в теге много (понятие растяжимое, но, к примеру, больше двадцати), то лучше выделить отдельным файлом.

<script>
  // последовательность инструкций JavaScript
</script>

Пример:

<script>
  function greet() {
    console.log("Привет!");
  }
  greet();
</script>

Этот шаблон используется для размещения логики непосредственно в теле HTML-документа. Код выполняется сразу при загрузке парсера до этого места.

Инициализация по событию DOMContentLoaded

<script>
  document.addEventListener("DOMContentLoaded", function() {
    // логика после построения DOM
  });
</script>

Этот шаблон гарантирует, что скрипт будет работать только после того, как вся HTML-разметка станет доступна.

Присвоение обработчика через свойство DOM-элемента

<script>
  document.getElementById("myButton").onclick = function() {
    // действие
  };
</script>

Альтернатива встроенным атрибутам: обработчик назначается программно, что улучшает разделение разметки и логики.

Ключевые атрибуты <script>:

• src: Указывает путь к внешнему файлу со скриптом. Если этот атрибут присутствует, содержимое тега - риется (внутренний код не выполняется).
• type: Определяет тип медиа-контента скрипта. Стандартное значение для JavaScript — text/javascript. В - емных стандартах HTML5 этот атрибут часто опускается, так как JavaScript является языком по умолчанию.
• defer: Указывает браузеру отложить выполнение скрипта до момента полной обработки HTML-документа - синга). Этпредотвращает блокировку рендеринга страницы.
• async: Загружает скрипт асинхронно (не дожидаясь окончания парсинга HTML) и выполняет его сразу после - уз, не гарантируя порядок выполнения нескольких скриптов с этим атрибутом.
• integrity: Используется для проверки целостности файла (SRI — Subresource Integrity) путем сравнения - зауженного файла с указанным значением (защита от подмены кода).
• crossorigin: Определяет режим передачи CORS (Cross-Origin Resource Sharing) при загрузке внешнего - пта.
• nonce / hash: Используются для реализации политик безопасности контента (CSP), разрешающих выполнение только определенных скриптов.

---

Подключение внешнего файла

Подключение внешнего файла – самый лучший вариант, когда JS-код пишется в отдельном файле с расширением .js, а в HTML указывается путь к этому файлу:

<script src="script.js" defer></script>

Использование атрибутов defer (для скриптов, зависящих от DOM) и async (для независимых скриптов, например, аналитики) позволяет оптимизировать время загрузки страницы.

Таким образом, к HTML-файлу добавляется ещё один файл, содержащий код. Он работает аналогично тегу <script>, но его содержимым будет являться ссылка на файл (в атрибуте «src». Если файл расположен в той же папке, что и HTML, можно просто указать, к примеру «script.js». Если же файл в другой папке, или размещён на каком-то сетевом ресурсе, то нужно указать путь к файлу (ссылку). Так, если страниц и скриптом много, они распределяются по папке согласно структуре, задуманной проектировщиком сайта. В самом JS-файле же, какие-либо открывающие/закрывающие теги не требуются. Просто код.

И только в самом начале разработки страницы «пустые», что может создать иллюзию безопасности в стиле «потом разберусь!».

Нет! Любой продукт со временем наращивает функционал, расширяясь, улучшаясь. Поначалу это «Привет!», а потом понадобится менять значение текста, а затем и локализовать на другие языки, добавлять дополнительную логику – вот поэтому лучше выделить код отдельно. А на практике, задачи совсем сложнее, и язык ппредоставляет гораздо больше возможностей.

<script src="app.js" defer></script>

или

<script src="analytics.js" async></script>

Эти шаблоны определяют момент выполнения скрипта:

• defer — после полной загрузки DOM;
• async — сразу после загрузки файла, без блокировки парсинга.

---

Выполнение кода

Скрипт выполняется в соответствии с кодом, указанным в файле/теге, и чтобы машина поняла человекочитаемый код, компиляция выполняется силами движка JS, который встроен в браузер.

JavaScript использует JIT-компиляцию.

JIT-компиляция (Just-In-Time) – компиляция «на лету», когда движок JS (например, V8) не компилирует весь код заранее, а делает это во время выполнения:

• сначала код выполняется построчно (медленно) – это интерпретация;
• потом движок находит «горячие» участки (часто выполняемый код) – это профилирование;
• «горячие» участки компилируются в машинный код для ускорения – это оптимизированная компиляция;
• если предположения движка оказались неверными, код возвращается к интерпретации – это деоптимизация.

---

Правила хорошего JS-кода

Хороший JS-код должен быть:

• читаемым (с отступами и комментариями);
• модульным (разбит на логические блоки);
• избегающим глобальных переменных (чтобы не было конфликтов).

Читаемость – понятие, конечно, субъективное, и если для новичка может быть что-то вполне читабельным, то для синьора – неприемлемо, либо наоборот. Здесь влияет и стиль написания, и стандарты в компании разработчика, и пожелания заказчика, и даже опыт программиста. Но принципа следует придерживаться следующего – дочерние элементы и строки лучше выделять отступом:

уровень 1
уровень 1 {
    уровень 2 {
        уровень 3
    } //закрывающие символы уровня 2
} //закрывающие символы уровня 1

Модульность подразумевает разделение по функциям, без «свалки». Словом, если у нас есть три функции, монолитно (едино) написали бы мы так:

функция {
    действие1;
    действие2;
    действие3;
}

Но если на практике это будет нечитабельно – это раз, и в случае разбора ошибок – вылетит вся функция, даже если ошибочно было лишь действие2. А если нам в другой части кода пригодится функционал действия3, то удобнее будет вызвать функцию, которая выполняет только действие3. Вот и весь смысл. Ведь намного удобнее разбираться в таком подходе:

функция1 {
    действие1;
}

функция2 {
    действие2;
}

функция3 {
    действие3;
}

---

Структура кода

Код состоит из следующих компонентов:

• импорты, которые указывают, какие дополнительные модули используются (если они нужны);
• константы и настройки – то, что будет использоваться в функциях;
• основные функции, содержащие логику;
• обработчики событий;
• инициализаторы;
• комментарии.

Все эти компоненты мы разберём позднее. Но для начала, нам нужно увидеть, как это выглядит на практике:

// так выглядит однострочный комментарий
/*
а вот так – 
многострочный комментарий
*/

// 1. Импорты
import { func } from './module.js';

// 2. Константы и настройки
const API_URL = "https://api.example.com";

// 3. Основные функции
function fetchData(url) {
  // ... логика загрузки данных
}

// 4. Обработчики событий для соответствующих объектов
document.getElementById("btn").addEventListener("click", () => {
  fetchData(API_URL);
});

// 5. Инициализация (запуск кода после загрузки страницы)
document.addEventListener("DOMContentLoaded", () => {
  console.log("Страница загружена!");
});

1. Импорт модулей

import { <имя> } from '<путь_к_модулю>';

Пример:

import { fetchData, validateInput } from './utils/api.js';

Этот шаблон описывает подключение внешних функций, классов или значений из других файлов. Он используется в начале файла и определяет зависимости текущего модуля.

2. Объявление констант и настроек

const <ИМЯ_КОНСТАНТЫ> = <значение>;

Пример:

const API_BASE_URL = "https://api.example.com/v1";
const MAX_RETRY_COUNT = 3;

Константы группируются в начале файла и используются как неизменяемые значения, задающие поведение программы.

3. Объявление функции

function <имяФункции>(<параметры>) {
  // тело функции
}

Пример:

function greetUser(name) {
  return `Привет, ${name}!`;
}

Функция инкапсулирует логически завершённую операцию и может быть вызвана из других частей программы.

4. Стрелочная функция (часто для обработчиков)

const <имя> = (<параметры>) => {
  // тело
};

Пример:

const handleClick = (event) => {
  console.log("Кнопка нажата:", event.target);
};

Стрелочные функции удобны для кратких действий и сохранения контекста this.

5. Присваивание переменной через деструктуризацию

const { <свойство1>, <свойство2> } = <объект>;

Пример:

const { id, name } = user;

Этот шаблон упрощает доступ к полям объекта и делает код более выразительным.

6. Вызов метода объекта

<объект>.<метод>(<аргументы>);

Пример:

document.getElementById("submit").addEventListener("click", handleSubmit);

Отражает взаимодействие с DOM или другими объектами через их интерфейсы.

7. Условный оператор

if (<условие>) {
  // действие при истине
} else if (<условие>) {
  // другое действие
} else {
  // действие по умолчанию
}

Пример:

if (user.isAuthenticated) {
  showDashboard();
} else {
  redirectToLogin();
}

Условные конструкции управляют потоком выполнения в зависимости от состояния данных.

8. Обработчик события

<элемент>.addEventListener("<событие>", <функцияОбработчик>);

Пример:

button.addEventListener("click", () => alert("Нажато!"));

Этот шаблон связывает пользовательские действия с логикой приложения без загромождения HTML.

9. Инициализация после загрузки DOM

document.addEventListener("DOMContentLoaded", () => {
  // инициализация
});

Пример:

document.addEventListener("DOMContentLoaded", initApp);

Гарантирует, что скрипт начнёт работу только после полной загрузки разметки.

---